<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//ZH-CN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<meta http-equiv="imagetoolbar" content="no" />
	<title>Class UI.Window</title>
	<link href="../resources/API_Help.css" type="text/css" rel="stylesheet" />
</head>

<body>
<!--打印本页-->
<div class="printCurrentPage">
	<img src="../resources/image/print.gif" align="absmiddle" />&nbsp;
	<a href="ui_Window_API.html" target="_blank">打印本页</a>
</div><br/>

<!--标题说明-->
<h1>Class UI.Window</h1>
<b>定义于文件：</b>&nbsp;&nbsp;ui_window.js
<div class="description">在浏览器页面中创建一个内建窗口。</div><br/>
<b>基本语法</b>
<div class="syntax">var window = new <b>UI.Window</b>( { [ <em>caption:String</em>,&nbsp;&nbsp;<em>width:Number</em>,&nbsp;&nbsp;<em>height:Number</em>,&nbsp;&nbsp;<em>min:boolean</em>,&nbsp;&nbsp;<em>max:boolean</em>,&nbsp;&nbsp;<em>flashed:boolean</em> ] } );</div>
<b>参数说明</b>
<div class="parameter">
	<ul>
		<li><em>caption</em> : String</li>
		<div class="subDesc">(可选参数) 内建窗口的标题文本, 默认值: Window。</div>
		<li><em>width</em> : Number</li>
		<div class="subDesc">(可选参数) 内建窗口的宽度, 默认值: 360px。</div>
		<li><em>height</em> : Number</li>
		<div class="subDesc">(可选参数) 内建窗口的高度, 默认值: 260px。</div>
		<li><em>min</em> : boolean</li>
		<div class="subDesc">(可选参数) 内建窗口是否有最小化按钮, 默认值: true。</div>
		<li><em>max</em> : boolean</li>
		<div class="subDesc">(可选参数) 内建窗口是否有最大化按钮, 默认值: true。</div>
		<li><em>flashed</em> : boolean</li>
		<div class="subDesc">(可选参数) 内建窗口是否有缩放效果, 默认值: true。</div>
	</ul>
</div>
<b>页面标签对象原型</b>
<div class="parameter">
	无
</div>
<b>依赖关系</b>
<div class="parameter">
	<a href="core_API.html">core.js</a>　　<a href="#">webui.js</a>
</div><br/>
<a href="#properties">相关属性</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#methods">相关方法</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#events">相关事件</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#examples">应用示例</a>
<hr>

<!--相关属性-->
<a name="properties"></a>
<h2>相关属性</h2>
<table width="100%" cellspacing="0">
	<tbody>
		<tr>
			<td class="tableHead" width="83%">所有属性</td>
			<td class="tableHead" width="17%">所属类</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#UI.Window.dom" class="methodLink">UI.Window.dom</a>&nbsp;:&nbsp;&lt;div&gt;<br/>
				内建窗口控件的页面标签对象。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#UI.Window.flash" class="methodLink">UI.Window.flash</a>&nbsp;:&nbsp;boolean<br/>
				内建窗口控件的缩放效果标志。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
	</tbody>
</table>

<!--相关方法-->
<a name="methods"></a>
<h2>相关方法</h2>
<table width="100%" cellspacing="0">
	<tbody>
		<tr>
			<td class="tableHead" width="83%">所有方法</td>
			<td class="tableHead" width="17%">所属类</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#center" class="methodLink">center</a>()&nbsp;:&nbsp;none<br/>
				设置内建窗口在浏览器中居中。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#clearPanel" class="methodLink">clearPanel</a>()&nbsp;:&nbsp;none<br/>
				清空内建窗口的主面板。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#focus" class="methodLink">focus</a>()&nbsp;:&nbsp;none<br/>
				设置内建窗口获得焦点。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#getPanel" class="methodLink">getPanel</a>()&nbsp;:&nbsp;Tag<br/>
				返回内建窗口主面板的页面dom标签对象。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#hide" class="methodLink">hide</a>()&nbsp;:&nbsp;none<br/>
				关闭内建窗口。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#hideIcon" class="methodLink">hideIcon</a>( <em>flag:boolean</em> )&nbsp;:&nbsp;none<br/>
				设置内建窗口的标题栏图标是否显示。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#onClose" class="methodLink">onClose</a>( <em>callBack:Function</em> )&nbsp;:&nbsp;none<br/>
				设置内建窗口的关闭动作事件回调。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#onOpen" class="methodLink">onOpen</a>( <em>callBack:Function</em> )&nbsp;:&nbsp;none<br/>
				设置内建窗口的打开动作事件回调。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#refresh" class="methodLink">refresh</a>()&nbsp;:&nbsp;none<br/>
				刷新内建窗口。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#show" class="methodLink">show</a>( <em>obj:Tag</em> )&nbsp;:&nbsp;none<br/>
				打开内建窗口。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#setBounds" class="methodLink">setBounds</a>( <em>X:Number</em>,&nbsp;&nbsp;<em>Y:Number</em> )&nbsp;:&nbsp;none<br/>
				设置内建窗口在浏览器中的显示位置。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#setCaption" class="methodLink">setCaption</a>( <em>text:String</em> )&nbsp;:&nbsp;none<br/>
				设置内建窗口的标题栏文本。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#setIcon" class="methodLink">setIcon</a>( <em>url:String</em> )&nbsp;:&nbsp;none<br/>
				设置内建窗口的标题栏图标。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#setPanel" class="methodLink">setPanel</a>( <em>id:String|Tag</em>,&nbsp;&nbsp;<em>resize:Function</em> )&nbsp;:&nbsp;none<br/>
				设置内建窗口的主面板。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#setSize" class="methodLink">setSize</a>( <em>width:Number</em>,&nbsp;&nbsp;<em>height:Number</em> )&nbsp;:&nbsp;none<br/>
				设置内建窗口的尺寸大小。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
	</tbody>
</table>

<!--相关事件-->
<a name="events"></a>
<h2>相关事件</h2>
<table width="100%" cellspacing="0">
	<tbody>
		<tr>
			<td class="tableHead" width="83%">所有事件</td>
			<td class="tableHead" width="17%">所属类</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#UI.Window.onCloseEvent" class="methodLink">UI.Window.onCloseEvent</a>&nbsp;:&nbsp;Function<br/>
				内建窗口的关闭动作事件。
			</td><td class="tableLineRight">UI.Window</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#UI.Window.onOpenEvent" class="methodLink">UI.Window.onOpenEvent</a>&nbsp;:&nbsp;Function<br/>
				内建窗口的打开动作事件。
			</td><td class="tableLineRight alt">UI.Window</td>
		</tr>
	</tbody>
</table>
<br/>

<hr>

<!--相关属性的详细说明-->
<h2>本类属性的详细说明</h2>
<div class="detailWrap">

<a name="UI.Window.dom"></a>
<div class="mdetail">
	<h3>UI.Window.dom</h3><br/>
	<div class="mdetailDetails">
		内建窗口控件的页面标签对象。<br/>
		通过 dom 属性可直接对内建窗口进行相关操作。
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="UI.Window.flash"></a>
<div class="mdetail alt">
	<h3>UI.Window.flash</h3><br/>
	<div class="mdetailDetails">
		内建窗口控件的缩放效果标志。<br/>
		通过 flash 属性可直接设置内建窗口是否有缩放效果。
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

</div><br/>

<!--相关方法的详细说明-->
<h2>本类方法的详细说明</h2>
<div class="detailWrap">

<a name="center"></a>
<div class="mdetail">
	<h3>center</h3>
	<div class="functionDefine">public function center()</div>
	<div class="mdetailDetails">
		设置内建窗口在浏览器中居中。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul><li>无</li></ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="clearPanel"></a>
<div class="mdetail alt">
	<h3>clearPanel</h3>
	<div class="functionDefine">public function clearPanel()</div>
	<div class="mdetailDetails">
		清空内建窗口的主面板。<br/>
		本方法是将内建窗口主面板的 dom 对象移到 body 标签下隐藏, 并设置内建窗口的调整回调方法为 null。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul><li>无</li></ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="focus"></a>
<div class="mdetail">
	<h3>focus</h3>
	<div class="functionDefine">public function focus()</div>
	<div class="mdetailDetails">
		设置内建窗口获得焦点。<br/>
		当浏览器中有多个内建窗口同时显示时, 本方法可以设置指定窗口为最上层显示。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul><li>无</li></ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="getPanel"></a>
<div class="mdetail alt">
	<h3>getPanel</h3>
	<div class="functionDefine">public function getPanel()</div>
	<div class="mdetailDetails">
		返回内建窗口主面板的页面dom标签对象。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul><li>无</li></ul>
		<b>返回值</b>
		<ul><li>Tag</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="hide"></a>
<div class="mdetail">
	<h3>hide</h3>
	<div class="functionDefine">public function hide()</div>
	<div class="mdetailDetails">
		关闭内建窗口。<br/>
		在调用本方法时会触发 <a href="#UI.Window.onCloseEvent" class="methodLink">onCloseEvent</a> 事件。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul><li>无</li></ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="hideIcon"></a>
<div class="mdetail alt">
	<h3>hideIcon</h3>
	<div class="functionDefine">public function hideIcon( flag:boolean )</div>
	<div class="mdetailDetails">
		设置内建窗口的标题栏图标是否显示。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>flag</em> : boolean</li>
			<div class="subDesc">参数的取值&nbsp;&nbsp;&nbsp;&nbsp;true: 隐藏, false: 显示。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="onClose"></a>
<div class="mdetail">
	<h3>onClose</h3>
	<div class="functionDefine">public function onClose( callBack:Function )</div>
	<div class="mdetailDetails">设置内建窗口的 onCloseEvent 动作事件回调。<br/>
	当事件触发时, 系统会自动调用 callBack 方法。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>callBack</em> : Function</li>
			<div class="subDesc">回调函数名。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="onOpen"></a>
<div class="mdetail alt">
	<h3>onOpen</h3>
	<div class="functionDefine">public function onOpen( callBack:Function )</div>
	<div class="mdetailDetails">设置内建窗口的 onOpenEvent 动作事件回调。<br/>
	当事件触发时, 系统会自动调用 callBack 方法。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>callBack</em> : Function</li>
			<div class="subDesc">回调函数名。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="refresh"></a>
<div class="mdetail">
	<h3>refresh</h3>
	<div class="functionDefine">public function refresh()</div>
	<div class="mdetailDetails">
		刷新内建窗口。<br/>
		当调用本方法时, 系统会自动调用内建窗口的调整方法重新设置内建窗口的布局。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul><li>无</li></ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="show"></a>
<div class="mdetail alt">
	<h3>show</h3>
	<div class="functionDefine">public function show( obj:Tag )</div>
	<div class="mdetailDetails">
		打开内建窗口。<br/>
		在调用本方法时会触发 <a href="#UI.Window.onOpenEvent" class="methodLink">onOpenEvent</a> 事件。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>obj</em> : Tag</li>
			<div class="subDesc">页面标签对象, 默认值: null 。<br/>
			当内建窗口的 flash 属性为 true 时, 调用本方法，内建窗口会从 obj 标签位置以缩放效果显示出来, <br/>obj 为 null 时, 内建窗口从浏览器中心以缩放效果显示出来。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="setBounds"></a>
<div class="mdetail">
	<h3>setBounds</h3>
	<div class="functionDefine">public function setBounds( X:Number, Y:Number )</div>
	<div class="mdetailDetails">设置内建窗口在浏览器中的显示位置。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>X</em> : Number</li>
			<div class="subDesc">在浏览器中的显示位置的X轴坐标。</div>
			<li><em>Y</em> : Number</li>
			<div class="subDesc">在浏览器中的显示位置的Y轴坐标。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="setCaption"></a>
<div class="mdetail alt">
	<h3>setCaption</h3>
	<div class="functionDefine">public function setCaption( text:String )</div>
	<div class="mdetailDetails">设置内建窗口的标题栏文本。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>text</em> : String</li>
			<div class="subDesc">标题栏文本, 默认值: Window 。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="setIcon"></a>
<div class="mdetail">
	<h3>setIcon</h3>
	<div class="functionDefine">public function setIcon( url:String )</div>
	<div class="mdetailDetails">设置内建窗口的标题栏图标, 图标为 16×16 的gif图片。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>url</em> : String</li>
			<div class="subDesc">标题栏图标路径地址, 默认值: 空 。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="setPanel"></a>
<div class="mdetail alt">
	<h3>setPanel</h3>
	<div class="functionDefine">public function setPanel( id:String|Tag, resize:Function )</div>
	<div class="mdetailDetails">设置内建窗口的主面板。<br/>注意: 内建窗口主面板中的控件一定要在调用本方法之前创建, 否则 resize 调整方法会找不到指定控件的变量。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>id</em> : String|Tag</li>
			<div class="subDesc">页面标签ID或是页面标签对象。 <br/>一般来说, 主面板是&lt;div&gt;标签或者&lt;table&gt;标签。</div>
			<li><em>resize</em> : Function</li>
			<div class="subDesc">
				内建窗口的主面板调整方法, resize 方法必须有两个参数, 在内建窗口大小改变时, 系统会自动把内建窗口的宽度和高度做为参数执行 resize 方法。<br/>
				resize 方法主要负责当内建窗口大小被改变时调整主面板布局的。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="setSize"></a>
<div class="mdetail">
	<h3>setSize</h3>
	<div class="functionDefine">public function setSize( width:Number, height:Number )</div>
	<div class="mdetailDetails">设置内建窗口的大小。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>width</em> : Number</li>
			<div class="subDesc">内建窗口的宽度, 默认值: 200px。</div>
			<li><em>height</em> : Number</li>
			<div class="subDesc">内建窗口的高度, 默认值: 120px。</div>
		</ul>
		<b>返回值</b>
		<ul><li>无</li></ul>
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

</div><br/>

<!--相关事件的详细说明-->
<h2>本类事件的详细说明</h2>
<div class="detailWrap">

<a name="UI.Window.onCloseEvent"></a>
<div class="mdetail">
	<h3>UI.Window.onCloseEvent</h3><br/>
	<div class="mdetailDetails">
		内建窗口的关闭动作事件。<br/>
		在内建窗口关闭时将会触发此事件, 具体的应用请参见方法 <a href="#onClose" class="methodLink">onClose</a> 的说明。
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

<a name="UI.Window.onOpenEvent"></a>
<div class="mdetail alt">
	<h3>UI.Window.onOpenEvent</h3><br/>
	<div class="mdetailDetails">
		内建窗口的打开动作事件。<br/>
		在内建窗口打开时将会触发此事件, 具体的应用请参见方法 <a href="#onOpen" class="methodLink">onOpen</a> 的说明。
	</div>
	<div class="footer since">@since JSR1.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="ui_Window_API.html">Return</a></div><br/>
</div>

</div><br/>

<!--应用示例-->
<a name="examples"></a>
<h2>应用示例</h2>
<div class="properties"><a href="../Example/ui_Window.html" target="_blank">ui_Window.html</a></div><br/>

<!--页脚-->
<hr>
<div class="footer">JSR - Copyright &copy; 2007-2008 Jsr JS, LLC<br/>All rights reserved.</div>
</body>
</html>
